Tableau Serverの『ダウングレード』を試してみる

Tableau Serverでは環境を『アップグレード』させる手順が整備されており、基本的には最新バージョン・新し目のバージョンに『アップグレード』させていくのが普通です。ですが状況に拠っては止むを得ない理由で環境のバージョンを戻す、所謂『ダウングレード』を必要とする場合もあるかも知れません。例えば一旦アップグレードしてみたけれど動作しない部分があったりしてすぐには改善が見込めない場合の緊急措置として元のバージョンに戻す、等です。Tableauのナレッジベースにこの『ダウングレード』手順が紹介されていましたので、現行最新バージョンv10.0と任意の過去バージョンでこの内容を試してみたいと思います。

• Rolling Back to an Earlier Installation of Tableau Server | Tableau Software

目次

• 1.Beforeな環境を用意(Tableau Server 9.2.0)
• 2.Afterな環境へのアップグレード(Tableau Server 10.0)
• 3.Beforeな環境へダウングレード(Tableau Server 9.2.0)
• まとめ

1.Beforeな環境を用意(Tableau Server 9.2.0)

まず始めに検証を行う上で必要となる環境を用意(Amazon EC2: Windows Server 2012 RTM R2 日本語版／Dドライブ100GBを追加)。Tableau Serverのインストーラも過去バージョンが入手出来る下記サイトから最新バージョン(v10.0)と任意の過去バージョン(今回はv9.2.0をチョイスしてみました)をそれぞれダウンロードしておきます。

• 予備ダウンロードページ | Tableau Software

ダウングレード対象となるバージョン(v9.2.0)のTableau Serverをインストール。

この時のインストールパスはD:¥Tableauとしています。(インストーラ側で自動的に¥Tableau Serverは補完されます)

インストールを進め、任意のプロジェクトを新規作成し、中にコンテンツをPublishしておきました。

そしてこのタイミングでtabadmin backupコマンドを使いバックアップファイルを作成しておきます。(このファイルを後程使ってリストアする形となります)

• tabadmin のコマンド - tabadmin backup

Windows PowerShell
Copyright (C) 2014 Microsoft Corporation. All rights reserved.

PS C:\Users\Administrator> D:
PS D:\> cd .\Tableau
PS D:\Tableau> cd '.\Tableau Server'
PS D:\Tableau\Tableau Server> cd .\9.2
PS D:\Tableau\Tableau Server\9.2> cd .\bin
PS D:\Tableau\Tableau Server\9.2\bin> .\tabadmin.exe backup D:\tableau-server-backup¥tableau-server-92-backup -d
===== Using as backup tmp directory: D:/Tableau/Tableau Server/data/tabsvc/temp (free space: 102.17 GB)
===== Cleaning entries from http_requests log older than 7 days
   -- Deleted 0 rows
===== Backing up database data
===== Backing up dataengine extracts
===== Backup of database data done
===== Backup of dataengine extracts done
===== Backup written to D:/tableau-server-backup/tableau-server-92-backup-2016-09-09.tsbak
PS D:\Tableau\Tableau Server\9.2\bin>

バックアップ作成完了。

2.Afterな環境へのアップグレード(Tableau Server 10.0)

次いで、この環境を最新v10.0にアップグレードさせます。

v10.0からは事前のバックアップ、前バージョンのアンインストールが手動で行わなくても良くなりました。

• 前バージョンをアンインストールせずにTableau Server 10へのアップグレードを行う(単一サーバ構成) ｜ Developers.IO

インストールパスは前バージョンのものと合わせます。

アップグレード完了。

バージョンも最新版のものとなっています。

3.Beforeな環境へダウングレード(Tableau Server 9.2.0)

そしてここからが今回の肝となる作業手順となります。現在のバージョン(v10.0)からの過去バージョン(v9.2.0)へのダウングレードです。まずは現行バージョン(v10.0)の環境を、『プログラムと機能』からアンインストール実施。

アンインストール完了後、バージョンごとに作成されているフォルダの該当バージョンのものを削除します。デフォルト値でのインストールであればC:\Program Files\Tableau\Tableau Server\となりますし、今回のエントリの内容で言えばD:\Tableau\Tableau Server\がその場所となります。

また併せてdataフォルダも削除してしまいます。デフォルト値での導入の場合だとC:\ProgramData\Tableau\Tableau Server\data、今回のエントリの内容だとD:\Tableau\Tableau Server\dataが該当します。

アンインストール＆フォルダ削除が完了したら前バージョン(v9.2.0)のTableau Serverを改めてインストール。

インストールパスを合わせるのはこれまで通り。

インストール完了。この時点では単純にインストールしただけですので環境も初期状態となっています。

tabadmin restoreコマンドを使い、既存取得済みのバックアップファイルからリストア作業を行います。

• tabadmin のコマンド - tabadmin restore

PS C:\Users\Administrator> D:
PS D:\> cd .\Tableau
PS D:\Tableau> cd '.\Tableau Server'
PS D:\Tableau\Tableau Server> cd .\9.2
PS D:\Tableau\Tableau Server\9.2> cd .\bin
PS D:\Tableau\Tableau Server\9.2\bin> .\tabadmin.exe restore D:\tableau-server-backup¥tableau-server-92-backup-2016-09-09.tsbak
===== Beginning to restore the backup
===== Stopping service...
   -- Service stopped successfully
===== Verifying backup manifest
   -- Restoring service configuration
===== Initializing Tableau Server File Store remotely
   -- Initiating built-in extract engine data restore
   -- Restoring service data from backup file
   -- Database restore completed.
   -- Migrations already up to date.
===== Validating Database schema signature
===== Database schema is different from the expected schema. Use tabadmin validate_schema_signature for further investigation.
===== Initializing Tableau Server Coordination Service 0 remotely
   -- Waiting for built-in extract engine data restore to finish.
   -- Extract engine data restore completed.
===== Migrating extract data to filestore...
===== Finished Migrating. Cleaning up unmigrated data...
===== Cleaning up any unmigrated folders.
   -- Restoring web data connectors
   -- Web data connectors were distributed to all gateways.
   -- Web data connectors restore completed.
  *** The run-as password is empty. If the run-as user is a built-in system account, this is likely fine. Otherwise, services will likely fail to start.
===== Locking permissions on D:/Tableau/Tableau Server/data
===== Locking permissions on D:/Tableau/Tableau Server/config
===== Building search index
===== Search index built
===== Backup restore completed
===== Enter "tabadmin start" to start the service
PS D:\Tableau\Tableau Server\9.2\bin>

リストアが完了したらTableau Serverを起動し、

PS D:\Tableau\Tableau Server\9.2\bin> .\tabadmin.exe start
===== Starting service...
   -- Service was started successfully
PS D:\Tableau\Tableau Server\9.2\bin>

Tableau Serverにアクセス。前バージョン(v9.2.0)で先程のコンテンツ一式が復元出来ました。

まとめ

Tableau Serverの『ダウングレード』手順に関するご紹介でした。いざとなったらこの手法を使って環境を戻すことが出来るのでアップグレード作業も思い切って出来ますね。こちらからは以上です。